home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
wildcat
/
plant11.zip
/
PLANTER.DOC
< prev
next >
Wrap
Text File
|
1992-11-18
|
18KB
|
458 lines
┌──────────────────────────────────────────────────┐
│ PLANTER ver 1.10 │
│ For WILDCAT! 3.x Systems │
│ (C) 1992 - LIFE DESIGN LTD. │
│ - All Rights Reserved - │
└──────────────────────────────────────────────────┘
Technical Support and the latest versions!
Sun Surf & Serenity
(708) 453-1321 2400
(708) 453-6630 9600 V.32/V42bis
Planter v1.10 - A Sysop utility for Wildcat BBS systems
────────────────────────────────────────────────────────────────────
- DESCRIPTION -
Planter began as a little utility to pass any door name or number and
the time it was accessed to your ACTIVITY.xxx. Planter can now add
just about anything you would want to the ACTIVITY.xxx; from DOS Hooks
to Mail Events.
Planter will notify you of any error it encounters in the %WCxxx%
environment and create a error report "planter.err" in the directory
it was run from.
Planter is semi-intelligent in that if run in a multi-node
environment, it will PLANT the appropriate information in the correct
activity.xxx
Planter is transparent to the remote user, and is quick enough
that it runs virtually undetected, save for a brief notice on the
local screen.
Planter runs in Desqview and Windows environments without conflict
or special configuration.
Planter is SHAREWARE! Please support the shareware experience.
Planter is Copyrighted, with ALL RIGHTS RESERVED by Chris Koziol of
Life Design Ltd.
Planter v1.10 - A Sysop utility for Wildcat BBS systems
────────────────────────────────────────────────────────────────────
- Installation -
1.) Copy PLANTER.EXE and PLANTER.CFG to any directory or
subdirectory in your path.
i.e. PATH=C:\;C:\DOS;D:\WC30;...etc
PLANTER.EXE & PLANTER.CFG may reside in any directory that is in
your path. While this is not absolutely necessary, it makes life
so much easier.
2.) Edit the included PLANTER.CFG file that is included.
line1: Sysop's Name ex: Chris Koziol
line2: BBS Name ex: Sun Surf & Serenity
line3: Registration No. ex: ?????????
PLANTER.CFG must be present for Planter v1.10 to run!!!
PLANTER.CFG should contain 3 lines with a normal carriage return
line feed at the end of each line.
** line3, should be BLANK if you have not yet registered PLANTER.
3.) Place the following statements in your CATx.BAT or batch file
that starts up your BBS.
SET WCHOME=C:\WC30 <<--or wherever your wildcat.exe,
tomcat.exe, activity.xxx reside
SET WCNODEID=X <<--should correspond to catX.bat.
EX. cat3.bat should contain:
SET WCNODEID=3
EX. cat13.bat should contain:
SET WCNODEID=13
EX. cat213.bat should contain:
SET WCNODEID=213
SET PLANT=D:\WCUTIL <<--should reflect the directory or
subdirectory where you placed the
PLANTER files.
*NOTE* X can be one to three digits in length.
!! DO NOT PREFIX "X" WITH LEADING "0"'s !!
Planter v1.10 will check to see if the environment variables have
been set. It will also check if the X is between one and three
digits. It WILL NOT check for the existence of the directories
nor for the "correctness" of node numbering. Please enter the
required information carefully.
If for any reason PLANTER does not find everything in order, the
program will notify you of the error by placing a "plant.err" in
the directory it was ran from with a brief description of the error
encountered. It will also alert you locally by briefly displaying an
error message to the local screen. Planter will then terminate and
your door will run as normal.
Planter v1.10 - A Sysop utility for Wildcat BBS systems
────────────────────────────────────────────────────────────────────
- Running Planter v1.10 -
Running PLANTER is very simple:
PLANTER [switch] [name]
EX. cd\door\pegjump
PLANTER /D PEG JUMP <<-- case is not important
pegjump pegjump.cnf capped only for emphasis
cd\wc30
Planter may also be run from within a batch file that is called
from another batch file:
EX. cd\door\pegjump
CALL STATS.BAT /D PEG JUMP
pegjump pegjump.cnf
cd\wc30
STATS.BAT =
cd\door <<-- changed to \door since my stats
stats %2 %3 %4 %5 program must run from there.
PLANTER %1 %2 %3 %4 %5 PLANTER may run from any dir.
"%1 %2 %3 %4 %5...etc" are needed to pass the switch and name to
PLANTER when it is run from within a batch file that is called
from another batch file:
EX. planter /D AVATARS OF SCREAMING STEAL
%1 %2 %3 %4 %5
*NOTE* Planter will accept only one "switch" and any "name" of up to
eight words, for a total of nine arguments passed.
- The Switches -
Switch PLANTED in ACTIVITY.xxx Purpose
────────────────────────────────────────────────────────────────────
/D Door Accessed: [name] Used in DOORx.BAT
/M Mail Event: [name] Used in any batch file to denote
mail runs, tossing, etc.
* /B Batch File: [name] Can be used for ANY batch file.
* /C Commenting: [name] Used to comment any process
* /E BBS Event: [name] Used in EVENT.BAT to denote
maintenance, resets, etc.
* /I Idle Screen: [name] Used for Batches run from the Idle
Screen.
* /H DOS Hook: [name] Used in MAIN/MSG/FILEx.BAT/RUN
* = REGISTERED VERSION ONLY
Planter v1.10 - A Sysop utility for Wildcat BBS systems
────────────────────────────────────────────────────────────────────
- Example Uses -
────────────────────────────────────────────────────────────────────
/D [name] -- Can be used in DOORx.BAT or in conjunction with a Door
Manager.
EX. cd\door\pegjump
PLANTER /D PEG JUMP <<-- can come before or after
pegjump pegjump.cnf the commands to run the door.
cd\wc30
Planter may also be run from within a batch file that is
called from another batch file:
EX. cd\door\pegjump
CALL STATS.BAT /D PEG JUMP
pegjump pegjump.cnf
cd\wc30
STATS.BAT =
cd\door <<-- changed to \door since my
stats %2 %3 %4 %5 stats program must run
PLANTER %1 %2 %3 %4 %5 from there. PLANTER may
run from any dir.
"%1 %2 %3 %4 %5...etc" are needed to pass the switch and name to
PLANTER when it is run from within a batch file that is called
from another batch file:
EX. planter /D AVATARS OF SCREAMING STEAL
%1 %2 %3 %4 %5
OUTPUT:
HH:MM √ Door Accessed: PEG JUMP
────────────────────────────────────────────────────────────────────
/H [name] -- Used in MAIN/MSG/FILEx.BAT/RUN, the DOS Hooks that are
provided by MSI.
EX. cd\wc30\wildcall
PLANTER /H CALLBACK VERIFIER
wildcall wildcall.cfg
cd\wc30
OUTPUT:
HH:MM √ DOS Hook: CALLBACK VERIFIER
Planter v1.10 - A Sysop utility for Wildcat BBS systems
────────────────────────────────────────────────────────────────────
/E [name] -- Used with any batch file that is used to run a BBS event.
EX. NIGHTLY.BAT=
cd\wcutil
PLANTER /E NIGHTLY MAINTENANCE STARTED
call tscan.bat
call logs.bat
call pack.bat
PLANTER /E NIGHTLY MAINTENANCE FINISHED
OUTPUT:
-------------------------------------------------------------------------------
HH:MM √ BBS Event: NIGHTLY MAINTENANCE STARTED MM/DD/YY
-------------------------------------------------------------------------------
HH:MM √ BBS Event: NIGHTLY MAINTENANCE FINISHED MM/DD/YY
────────────────────────────────────────────────────────────────────
/C [name] -- Used with ANY batch file, for commenting ACTIVITY.xxx
This is useful if you wish to comment different actions taking
place in events. For instance take the preceding example of the
nightly maintenance batch file; you could in effect:
EX. NIGHTLY.BAT=
cd\wcutil
PLANTER /E NIGHTLY MAINTENANCE STARTED
PLANTER /C TRANSCAN PROCESSING...
call tscan.bat
PLANTER /C SORTING AND TRIMMING LOGS...
call logs.bat
PLANTER /C STORING LOGS IN E:\BBSLOGS...
call pack.bat
PLANTER /E NIGHTLY MAINTENANCE FINISHED
OUTPUT:
-------------------------------------------------------------------------------
23:50 √ BBS Event: NIGHTLY MAINTENANCE STARTED 11/17/92
23:50 √ Commenting: TRANSCAN PROCESSING...
23:52 √ Commenting: SORTING AND TRIMMING LOGS...
23:56 √ Commenting: STORING LOGS IN E:\BBSLOGS...
-------------------------------------------------------------------------------
23:58 √ BBS Event: NIGHTLY MAINTENANCE FINISHED 11/17/92
ALTERNATELY you could pass the parameters to the batch files called
from within NIGHTLY.BAT as in:
EX. NIGHTLY.BAT=
cd\wcutil
PLANTER /E NIGHTLY MAINTENANCE STARTED
call tscan.bat /C TRANSCAN PROCESSING...
call logs.bat /C SORTING AND TRIMMING LOGS...
call pack.bat /C STORING LOGS IN E:\BBSLOGS...
PLANTER /E NIGHTLY MAINTENANCE FINISHED
And in each batch file that is "called" include as the first line:
PLANTER %1 %2 %3 %4 %5 %6 ... etc.
The resulting OUTPUT would be the same.
Planter v1.10 - A Sysop utility for Wildcat BBS systems
────────────────────────────────────────────────────────────────────
/M [name] -- Used in the batch file that performs your "Mailruns" to
other systems.
EX. MSIMAIL.BAT=
PLANTER /M MSI MAILRUN STARTED
if exist c:\mail\mustang.rep goto mail_out
cd\wc30
tnet export mustang
:mail_out
cd\robo
robocomm /AMSI-MAIL /R /P
if exist c:\mail\1mustang.rep del c:\mail\1mustang.rep
cd\wc30
if exist c:\mail\mustang.qwk goto mail_in
PLANTER /C MSI MAILRUN *FAILED*
goto end
:mail_in
tnet import mustang
del c:\mail\mustang.qwk
:end
PLANTER /M MSI MAILRUN FINISHED
OUTPUT: (if transfer successful)
-------------------------------------------------------------------------------
02:30 √ Mail Event: MSI MAILRUN STARTED 11/17/92
-------------------------------------------------------------------------------
02:37 √ Mail Event: MSI MAILRUN FINISHED 11/17/92
OUTPUT: (if unsuccessful)
-------------------------------------------------------------------------------
02:30 √ Mail Event: MSI MAILRUN STARTED 11/17/92
02:37 √ Commenting: MSI MAILRUN *FAILED*
-------------------------------------------------------------------------------
02:37 √ Mail Event: MSI MAILRUN FINISHED 11/17/92
As you can see from this last example, by controlling batchfile flow
and using the /C switch, you can also comment in results of any
process.
────────────────────────────────────────────────────────────────────
/B [name] -- Used in ANY batch file that you want noted to the
ACTIVITY.xxx log
EX. MYBAT.BAT=
cd\wcutil
PLANTER /B CALLER ID
callerid callerid.cfg
cd\wc30
OUTPUT:
23:52 √ Batch File: CALLER ID
Planter v1.10 - A Sysop utility for Wildcat BBS systems
────────────────────────────────────────────────────────────────────
/I [name] -- Used for commenting ACTIVITY.xxx with the batch files
that are run from the Idle Screen.
EX. PRO.BAT=
cd\wc30
PLANTER /I WCPRO STATS GENERATED
wcpro
OUTPUT:
-------------------------------------------------------------------------------
02:37 √ Idle Screen: WCPRO STATS GENERATED 11/17/92
────────────────────────────────────────────────────────────────────
- About the Output -
To see PLANTER's typical output, view the SAMPLE.TXT that is included
in this package.
You may have noticed in the previous examples that some of the PLANTED
information looks different for different switches. Indeed it is!
PLANTER strives to be as compatible as possible to the myriad of
activity log scanners, trimmers, packers that are currently available.
PLANTER has been tested with a good number of these different
utilities and has performed flawlessly. But as always the may be a few
that it just will not work with, giving flawed logs. If this should
happen, just drop me a note at any of the resources listed at the end
of this document and I will see what I can do.
Disclaimer
Life Design Ltd. hereby disclaims all warranties relating to
this product, whether express or implied, including without
limitation any implied warranties of merchantability or fitness
for a particular purpose. Life Design Ltd. cannot and will not
be liable for any special, incidental, consequential, indirect or
similar damages due to loss of data or any other reason, even if
Life Design Ltd. or an authorized Life Design Ltd. agent has
been advised of the possibility of such damages. In no event
shall the liability for any damages ever exceed the price paid for
the license to use software, regardless of the form and/or extent
of the claim. The user of this program bears all risk as to the
quality and performance of the software.
Planter v1.10 - A Sysop utility for Wildcat BBS systems
────────────────────────────────────────────────────────────────────
Copyright
Regardless of the method of marketing used, Planter v1.10 is NOT in
the "Public Domain". It is copyrighted by Chris Koziol and Life
Design Ltd.
License
Planter v1.10 is a SHAREWARE product. As such, it is made available
to the general computing public and anyone that may find it
useful. Unlimited use of the Unregistered Demo is granted, although I
strongly encourage registration for the full version. You may
distribute the Unregistered Demo version of Planter v1.10 in its
original form with original documentation.
Registration
As a SHAREWARE product, registration of Planter v1.10 is requested.
The cost is $10.00, which entitles free support, and any and all
future upgrades. See REGISTER.TXT for further information.
Please send any cash, comments or criticism to Chris Koziol to:
Life Design Ltd.
c/o Chris Koziol
2310 N. Harlem Ave.
Elmwood Park , IL 60635
Technical Support
If you have any compatibility problems with PLANTER and any activity
log scanner, trimmer, packer you should contact me at the resources
listed below.
Also enclose a copy of your ACTIVITY.xxx (pre- scan/trim/packed) and a
second copy of your ACTIVITY.xxx (post- scan/trim/packed), the name
and version number(!) of the utility that PLANTER is conflicting with,
and a brief description of the problem you are experiencing.
Comments and suggestions about Planter v1.10 are welcome, as well as
any comments or suggestions that you may have in terms of additional
utilities you would like to see written.
You may reach me at:
Sun Surf & Serenity
[708] 453-1321 2400
[708] 453-6630 9600 V.32
Log on as: "PLANTER USER SUPPORT"
for immediate access.
NETMAIL at: Or drop a note in:
WILDCAT or OFF-TOPIC Echo of MSI SupportNet.
Fidonet 1:115/113 SHAREWARE Echo on Fidonet
RealNet 54:6214/1 SYSOP HELP Echo on Realnet